home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / othergnu / gp2st.zoo / gnuplot / readme.st < prev   
Encoding:
Text File  |  1991-06-04  |  3.1 KB  |  89 lines
  1.         r e a d m e . s t 
  2.  
  3.  
  4. This port of GNUPLOT2 uses the GCC 1.39 compiler. The `make' program
  5. at termiator.cc.umich (GNUMAKE 3.58) doesn't have enough virtual
  6. memory (stack space) to process the rules for term.o.  Therefore the
  7. rule for ``unsafe-gnuplot'' is added to generate the linking command.
  8. So, to compile (with GCC)
  9.     gcc -O -Iterm -c term.c
  10.     make -f makefile.st unsafe-gnuplot
  11. For debugging, compile with 
  12.     gcc -O -g -Iterm -c erm.c
  13.     make -f makefile.st g-unsafe-gnuplot
  14. with GCC 1.39 later than april -91
  15.  
  16. For using the coprocesor (memory-mapped, *not* TT), compile with
  17.     gcc -O -Iterm -c term.c
  18.     make -f makefile.st c-unsafe-gnuplot
  19.  
  20.     GRAPHICS
  21.  
  22. The atari graphics driver works with VDI calls only, meaning that it
  23. should be possible to use colour, large screens, etc with a minimum of
  24. hassle (by virtue of not using LINEA and/or hardwired constants). The
  25. driver works out the size of the terminal font (possibly different
  26. from the graphics text font..) and leaves room for one line of text
  27. under the graphics image.
  28.  
  29.     LIBRARIES
  30.  
  31. you need patchlevel 66+ (or something) of the Atari libraries (the
  32. versions that include vdiesc.c + the extensions to vdibind.h) to get
  33. the vdi ESC functions.
  34. If you have patchlevel 66 (and possibly less), you should
  35.     -a Add a ``s++;'' statement to the first while loop of `strtod()'
  36.        in file `atof.c'. Look at it, you'll know what I mean.. .
  37.     -b Add a statement ``if(!isalnum(c)) break;'' to the main
  38.        loop in `strtol()' in file `strtol.c'. Otherwise the string
  39.        "10]" gets converted to the value 106. 
  40.  
  41.     ``FEATURES''
  42.  
  43. Compiling with 16-bit integers is possible (once you track the
  44. misuse/misdeclaration of ```alloc()'' (assumes that sizeof(char *) ==
  45. sizeof(int)). The size and speed improvements are truly neglible,
  46. however, and the help system fails to work, so I use 32 bit ints.. .
  47.  
  48. It seems that shell escape does work, in that a `!gulam' lands me in
  49. gulam. Single commands, e.g. `!ls', in a gnuplot launched from gulam
  50. do *not* work, however, so it's not really satisfactory. 
  51.  
  52.  
  53.     READLINE
  54.  
  55. I put in GNU readline to provide a reasonable command line interface.
  56. Using readline, the arrow keys do what we want, ALT works as META for
  57. the typical emacs commands (I took out VI commands as they screwed up
  58. the compile of the test version of readline). GNU readline was
  59. incorporated in GNUPLOT2.0 but *not* in GNUPLOT2.01, so I put it back
  60. in (I had ported GNUPLOT 2.0 first..). I haven't got the faintest idea
  61. why anyone would want to take out GNU readline. Of course, the
  62. copyleft applies to this port, but who cares?
  63.  
  64.  
  65.     KEYASSIGNMENTS
  66.  
  67. The readline library is hooked up to accept the ST special keys (arrow
  68. keys, HOME-END etc) as editing keys. Here is a list of key assignments
  69.  
  70.     LEFTARROW        backwards
  71.     RIGHTARROW        forwards
  72.     UPARROW            previous_history
  73.     DOWNARROW        next_history
  74.     ^LEFTARROW        backwards_word
  75.     ^RIGHTARROW        forwad_word
  76.     ^UPARROW        beg_history
  77.     ^DOWNARROW        end_history
  78.     HOME            beg_line
  79.     END            end_line
  80.     PAGEUP            beg_history
  81.     PAGEDOWN        end_history
  82.     DELETE            rubout
  83.     UNDO            undo
  84.  
  85.  
  86. Have fun,
  87.     Jens Tingleff 2 June -91
  88.  
  89.